DB004 arrayForth User's Manual
2.3 arrayForth User Vocabulary
This section lists resident words (those accessible after empty) that are relevant when operating arrayForth and when
using it to program the F18. These are all x86 functions, not F18 functions; for F18 compiler syntax see section 5.3
below Unless otherwise noted, you will normally use these words at the keyboard or use them in yellow when edited
into source blocks such as scripts for the x86 utilities. Do not assume you know what a Forth word does until you have
read it in this Manual! Words and conventions necessary for programming the x86 are not listed here. x86 colorForth
programming involves unusual conventions, such as the way in which macros interact with compilation and
interpretation, and the semantics of words like if and next.
named (_) sets an ASCII pathname
System Control
Words Usable in Blue
cr starts a new line in display.
br double spaced break in display.
in fnam for use by utilities.
The pathname is a single word
that may be up to 79
boot resets CPU sending it back to
the BIOS. Native only.
characters long. From the
keyboard the word will be
yellow; in source code it should
be white. Character
transformations are made from
cF {;'+@?*} to ASCII {:"=<>}
and space.
-cr prevents new line on next red
warm restarts the kernel, emptying
dictionary and interpreting
block 18.
word.
indent starts a new line indented
three spaces.
c clears the stack, also corrects stack
underflow.
Interpreter Control
load (b) interprets block b ,
pause lets the background task run.
Practical use is to update
display.
normally an even number.
Dictionary Management
mark saves the present state of the
dictionary for later restoration
by empty.
loads (bn) interprets n
consecutive source blocks
starting with block b .
abort terminates program
execution. The last word
interpreted from keyboard is
displayed with a question
mark. The editor is positioned
if possible to indicate the
source of the trouble. The top
stack item is discarded.
thru (f l) interprets consecutive
source blocks f through and
including l .
empty restores the dictionary to the
most recent mark.
remember a class definer. The
words in its class save the
present state of the dictionary
following their definition and
when executed restore the
dictionary to that point. Use:
reclaim remember.
finish interprets the current
editor block starting at the
editor's cursor position.
qwerty selects standard keyboard
fh (i-n) "from here" used to
simplify relocation of chunks of
code including their load block;
when interpreted from a block,
returns sum of that block's
number and i . When
layout and operation.
seeb toggles between visibility and
invisibility of blue words.
here (-b) returns byte address of
next available byte in
dictionary.
r? (-n) returns the number of
words on the return stack.
bye closes files and exits arrayForth.
interpreted from keyboard,
returns sum of i and the
current editor block number.
h (-a) a variable whose value is
Win32 only.
returned by here.
a-com (-n) returns the COM port
, (n) appends the given 32-bit
number for EVB001 USB port A.
exit causes the interpreter to stop
processing a block when it is
encountered.
word to the dictionary.
a-bps (-n) returns the baud rate
' (_-b) tick. Returns byte address
of the definition whose name
follows. Use from keyboard or
in a block.
desired for USB port A.
orgn (-a) a variable used to
register utilities that should be
reloaded after recompile has
compiled F18 source code.
c-com (-n) returns the COM port
number for EVB001 USB port C.
c-bps (-n) returns the baud rate
fill (wan) fills memory for n
words starting at a with the
value w .
desired for USB port C.
-msg stops any active display in
the message area.
move (sdn) copies n consecutive
words from word address s to
word address d.
Copyright© 2010-2011 GreenArrays, Inc. 10/30/13
11